home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 1 / The Arsenal Files (Arsenal Computer).ISO / clipper / 52cus.txt < prev    next >
Text File  |  1993-09-15  |  17KB  |  424 lines
  1. Dear CA-Clipper 5.2 Developer, This file contains:
  2.  
  3.       A. The instructions for applying the CA-Clipper 5.2c patch to any 
  4.          North American version of CA-Clipper 5.2 including: 5.20, 5.2a 
  5.          or 5.2b.  Please review these instructions carefully before 
  6.          attempting to apply the patch.
  7.  
  8.       B. The problem resolutions contained in the CA-Clipper 5.2c patch.
  9.  
  10.       C. A technical note pertaining to a problem within the RLOCK() and
  11.          DBRLOCK() functions.
  12.  
  13.  
  14. ==============================================================================
  15. A. Instructions for patching 5.2 (any rev.) to 5.2c (rev. 204).
  16.  
  17. REQUIRED FILES FOR PERFORMING UPDATE:
  18.  
  19.    52CUS.EXE            A self extracting ZIP file that may be 
  20.                         downloaded from the CLIPPER forum (library 0) 
  21.                         on CompuServe. (GO CLIPPER).
  22.  
  23.    PATCH.EXE            Updating engine required for use with all 52C 
  24.                         *.RTPs.  This file is also in Library 0 of the 
  25.                         CLIPPER CompuServe forum.
  26.  
  27.  
  28. CONTENTS OF 52CUS.EXE:
  29.  
  30.    INSTALL.EXE          Installation engine required for performing the 
  31.                         CA-Clipper 5.2c installation patch.
  32.  
  33.    DISK.ID              Installation identification file.
  34.  
  35.    INSTALL.DAT          Installation script file.
  36.  
  37.    CLP52INC.LIF         Compressed update file for CLIPPER5\INCLUDE
  38.  
  39.    52CDBU.LIF           Compressed update file for CLIPPER5\SOURCE\DBU
  40.  
  41.    52COBJ.LIF           Compressed update file for CLIPPER5\OBJ
  42.  
  43.    52CRL.LIF            Compressed update file for CLIPPER5\SOURCE\RL
  44.  
  45.    52CSAMPL.LIF         Compressed update file for CLIPPER5\SOURCE\SAMPLE
  46.  
  47.    52CSYS.LIF           Compressed update file for CLIPPER5\SOURCE\SYS
  48.  
  49.    CLP52BIN.RTP         Update file for CLIPPER5\BIN
  50.  
  51.    CLP52LIB.RTP         Update file for CLIPPER5\LIB
  52.  
  53.    CLP52NG.RTP          Update file for NG
  54.  
  55.    52CUS.TXT            This file.
  56.  
  57.  
  58. UPDATE PROCESS:
  59.  
  60. 1.   o    Download the 52CUS.EXE file from Compuserve.
  61.  
  62. 2.   o    Make sure that you have placed PATCH.EXE in a directory
  63.           which is in your DOS path.
  64.  
  65. 3.   o    Move to your CA-Clipper 5.2 directory.
  66.                EXAMPLE: C:\> CD\CLIPPER5
  67.  
  68. 4.   o    Backup your current version of CA-Clipper.
  69.  
  70. 5.   o    If you have applied either the CA-Clipper 5.2a or 5.2b patch, 
  71.           your BIN, LIB, INCLUDE and SOURCE\SAMPLE sub-directories may 
  72.           contain prior versions of CA-Clipper 5.2.  These sub-directories 
  73.           may cause the wrong version to be updated.  Therefore, you must 
  74.           remove them from the CA-Clipper 5.2 directory structure before 
  75.           applying the CA-Clipper 5.2c patch.  This can be accomplished 
  76.           be either deleting them or moving them out the CA-Clipper 5.2 
  77.           directory structure.  If you have not applied the 
  78.           CA-Clipper 5.2a or the 5.2b patch, you may skip this step and 
  79.           proceed to step 6.
  80.              EXAMPLE: C:\CLIPPER5> del c:\clipper5\bin\backup
  81.                       C:\CLIPPER5> rd c:\clipper5\bin\backup
  82.                       C:\CLIPPER5> del c:\clipper5\lib\backup
  83.                       C:\CLIPPER5> rd c:\clipper5\lib\backup
  84.                       C:\CLIPPER5> del c:\clipper5\include\backup
  85.                       C:\CLIPPER5> rd c:\clipper5\include\backup
  86.                       C:\CLIPPER5> del c:\clipper5\source\sys\backup
  87.                       C:\CLIPPER5> rd c:\clipper5\source\sys\backup
  88.  
  89. 6.   o    Move to the disk drive and directory where the patch files are
  90.           stored.
  91.                 EXAMPLE: C:\CLIPPER5> CD\52CUS
  92.  
  93. 7.   o    Insert a blank formated diskette in the A: drive and move to it.
  94.                 EXAMPLE: C:\52CUS> A:
  95.  
  96. 8.   o    Execute the 52CUS.EXE file.
  97.                 EXAMPLE: A:\> C:52CUS
  98.  
  99. 9.   o    Execute the installation program and follow it's simple 
  100.           instructions.
  101.                 EXAMPLE: A:\> INSTALL
  102.  
  103. 10.  o    Compare the date and time stamps of the updated files against 
  104.           the file list (below). If you have encountered a problem that 
  105.           you are unable to correct, call your CA-Clipper Level-I 
  106.           Technical Support representative.
  107.  
  108.  
  109. 11.  o    If you have applied the CA-Clipper 5.2c patch in a directory 
  110.           other than the one into which you installed the original 
  111.           CA-Clipper 5.2 version, you must make sure that your 
  112.           PATH, INCLUDE, OBJ, and LIB environment variables have been 
  113.           correctly set to point to the updated version of CA-Clipper.
  114.           Example: 
  115.                   (Scenario: You installed CA-Clipper 5.2 in C:\CLIPPER5
  116.                   and later renamed the directory (or moved the files) 
  117.                   to C:\CLIP52C.)
  118.                   A:\ SET PATH=C:\CLIP52C\BIN
  119.                   A:\ SET INCLUDE=C:\CLIP52C\INCLUDE
  120.                   A:\ SET OBJ=C:\CLIP52C\OBJ
  121.                   A:\ SET LIB=C:\CLIP52C\LIB
  122.  
  123.           NOTE: You should also change these settings in your AUTOEXEC.BAT file.
  124.  
  125. 12.  o    Move to your DBU directory, define RTLINK's behavior and
  126.           re-compile DBU.
  127.           EXAMPLE:
  128.                   A:\> C:
  129.                   C:\NG> CD \CLIPPER5\SOURCE\DBU
  130.                   C:\CLIPPER5\SOURCE\DBU> SET RTLINKCMD=
  131.                   C:\CLIPPER5\SOURCE\DBU> RMAKE DBU
  132.  
  133.      o    Copy DBU.EXE to your BIN directory.
  134.           EXAMPLE:
  135.                   C:\CLIPPER5\SOURCE\DBU> COPY DBU.EXE C:\CLIPPER5\BIN
  136.  
  137.      o    Delete the executable and object files that were created 
  138.           during the re-compilation process.
  139.           EXAMPLE:
  140.                   C:\CLIPPER5\SOURCE\DBU> DEL *.exe
  141.                   C:\CLIPPER5\SOURCE\DBU> DEL *.obj
  142.  
  143. 13.  o    Move to your RL directory, re-compile RL.
  144.           EXAMPLE:
  145.                   C:\CLIPPER5\SOURCE\DBU> CD \CLIPPER5\SOURCE\RL
  146.                   C:\CLIPPER5\SOURCE\RL> RMAKE RL
  147.  
  148.      o    Copy RL.EXE to your BIN directory.
  149.           EXAMPLE:
  150.                   C:\CLIPPER5\SOURCE\RL> COPY RL.EXE C:\CLIPPER5\BIN
  151.  
  152.      o    Delete the executable and object files that were created 
  153.           during the re-compilation process.
  154.           EXAMPLE:
  155.                   C:\CLIPPER5\SOURCE\RL> DEL *.exe
  156.                   C:\CLIPPER5\SOURCE\RL> DEL *.obj
  157.  
  158. 14.  o    Move to your PE directory, re-compile PE.
  159.           EXAMPLE:
  160.                   C:\CLIPPER5\SOURCE\RL> CD \CLIPPER5\SOURCE\PE
  161.                   C:\CLIPPER5\SOURCE\PE> RMAKE PE
  162.  
  163.      o    Copy PE.EXE to your BIN directory.
  164.           EXAMPLE:
  165.                   C:\CLIPPER5\SOURCE\PE> COPY PE.EXE C:\CLIPPER5\BIN
  166.  
  167.      o    Delete the executable and object files that were created 
  168.           during the re-compilation process.
  169.           EXAMPLE:
  170.                   C:\CLIPPER5\SOURCE\PE> DEL *.exe
  171.                   C:\CLIPPER5\SOURCE\PE> DEL *.obj
  172.  
  173. 15.  o    Move to your PLL directory, rebuild BASE52.PLL and BASE52.PLT.
  174.           EXAMPLE:
  175.                   C:\CLIPPER5\SOURCE\PE> CD \CLIPPER5\PLL
  176.                   C:\CLIPPER5\PLL> RTLINK @BASE52
  177.  
  178.      o    Do not become alarmed if the message: "Undefined Symbols... 
  179.           should be resolved at EXE generation" appears during this 
  180.           step.
  181.  
  182. 16.  o    The update process is now complete.
  183.         
  184.  
  185. LIST OF CHANGED FILES:
  186.  
  187.      o    This is a list of all files that have changed since the 
  188.           release of CA-Clipper 5.2.
  189.  
  190.      o    The files that have a date stamp of 03-15-93 and a time stamp 
  191.           of 5:21am have been updated by the CA-Clipper 5.2a patch.
  192.  
  193.      o    The files that have a date stamp of 06-10-93 and a time stamp 
  194.           of 5:22pm have been updated by the CA-Clipper 5.2b patch.
  195.  
  196.      o    The files that have a date stamp of 07-07-93 and a time stamp 
  197.           of 12:00pm have been updated by the CA-Clipper API diskette.
  198.  
  199.      o    The files that have a date stamp of 08-06-93 and a time stamp 
  200.           of 5:23pm have been updated by the CA-Clipper 5.2c patch.
  201.  
  202.      o    The files: DBU.EXE, RL.EXE, PE.EXE, BASE52.PLL and BASE52.PLT
  203.           will will have the date and time stamp of when they were most
  204.           recently re-built.
  205.  
  206.      o    All other files should have a date stamp of 02-15-93 and a 
  207.           time stamp of 5:20am.  These are the files that have never 
  208.           been updated by any of the CA-Clipper 5.2 patches.
  209.  
  210.      o    Directory of C:\CLIPPER5\BIN
  211.           
  212.           CLD      HLP     19677 06-10-93   5:22p
  213.           CLD      EXE     54351 08-06-93   5:23p
  214.           CLIPPER  EXE    200644 08-06-93   5:23p
  215.       
  216.           
  217.      o    Directory of C:\CLIPPER5\INCLUDE
  218.           
  219.           CLIPDEFS H        1703 06-10-93   5:22p
  220.           RULES    RMK      2312 07-07-93  12:00p
  221.           EXTEND   API      2194 08-06-93   5:23p
  222.           EXTEND   H         238 08-06-93   5:23p
  223.           FILESYS  API      2652 08-06-93   5:23p
  224.           GT       API      2734 08-06-93   5:23p
  225.           INKEY    CH       8579 08-06-93   5:23p
  226.           ITEM     API      1802 08-06-93   5:23p
  227.           RDD      API     27714 08-06-93   5:23p
  228.           STD      CH      51452 08-06-93   5:23p
  229.           VM       API      1093 08-06-93   5:23p
  230.           ACHOICE  CH        951 08-06-93   5:23p
  231.           ERROR    API      2090 08-06-93   5:23p
  232.           FM       API       811 08-06-93   5:23p
  233.           RDDSYS   CH        342 08-06-93   5:23p
  234.       
  235.           
  236.      o    Directory of C:\CLIPPER5\LIB
  237.           
  238.           CLD      LIB     80719 06-10-93   5:22p
  239.           ANSITERM LIB     11809 06-10-93   5:22p
  240.           SAMPLES  LIB     53891 06-10-93   5:22p
  241.           DBFNDX   LIB     27175 06-10-93   5:22p
  242.           NOVTERM  LIB     13345 06-10-93   5:22p
  243.           PCBIOS   LIB     13857 06-10-93   5:22p
  244.           TERMINAL LIB     13857 06-10-93   5:22p
  245.           CLIPPER  LIB    513181 08-06-93   5:23p
  246.           DBFNTX   LIB     38977 08-06-93   5:23p
  247.           EXTEND   LIB    126905 08-06-93   5:23p
  248.           DBFCDX   LIB    107993 08-06-93   5:23p
  249.           
  250.  
  251.      o    Directory of C:\CLIPPER5\OBJ
  252.           
  253.           CT2PATCH OBJ      4703 03-15-93   5:21a
  254.           NTXLOCK2 OBJ       302 06-10-93   5:22p
  255.           CDXLOCK  OBJ      6679 08-06-93   5:23p
  256.           
  257.  
  258.      o    Directory of C:\CLIPPER5\SOURCE\DBU
  259.           
  260.           DBUNET   PRG      8931 06-10-93   5:22p
  261.           DBUCOPY  PRG     17556 08-06-93   5:23p
  262.           DBUVIEW  PRG     67609 08-06-93   5:23p
  263.           
  264.  
  265.      o    Directory of C:\CLIPPER5\SOURCE\RL
  266.           
  267.           RLDIALG  PRG     10626 06-10-93   5:22p
  268.           RL       RMK       436 06-10-93   5:22p
  269.           RLBACK   PRG     40489 08-06-93   5:23p
  270.           RLFRONT  PRG     40165 08-06-93   5:23p
  271.           
  272.  
  273.      o    Directory of C:\CLIPPER5\SOURCE\SAMPLE
  274.           
  275.           BROWSE   PRG     10294 06-10-93   5:22p
  276.           TBDEMO   PRG     12398 06-10-93   5:22p
  277.       
  278.           
  279.      o    Directory of C:\CLIPPER5\SOURCE\SYS
  280.           
  281.           FRMBACK  PRG     17966 08-06-93   5:23p
  282.           FRMRUN   PRG     28512 08-06-93   5:23p
  283.  
  284.  
  285. ==============================================================================
  286. B. Problems resolved by CA-Clipper 5.2c:
  287.  
  288.  
  289.         1.  Fixed most instances of the DBFNTX/1210 error.
  290.  
  291.         2.  Fixed INDEXKEY() so that when it is called with an invalid 
  292.             order argument it will no longer corrupt the data at memory 
  293.             location 0000:0000 in dos and will no longer generate a 
  294.             General Protection Error in Exospace.
  295.  
  296.         3.  Fixed CMEM.OBJ (in Clipper.lib) so that the malloc(), 
  297.             _fmalloc(), free() and _ffree() memory allocation functions 
  298.             will return the correct information.
  299.  
  300.         4.  Fixed VM Integrity error when evaluating detached code 
  301.             blocks that are nested three or more deep.
  302.  
  303.         5.  Fixed VAL() so it no longer left justifys the result.
  304.  
  305.         6.  Fixed ACHOICE() so that it will not redraw the menu window 
  306.             after returning from the user specified function unless:
  307.                 A. the user specified function changes the number of 
  308.                    elements in the menu array.
  309.                 B. the user specified function returned the new return 
  310.                    code of AC_REDRAW (which can be found in ACHOICE.CH 
  311.                    and has the numeric value of 4).
  312.  
  313.         7.  Fixed the Expanded Memory Manager so it will not attempt to 
  314.             use more than eight megabytes of EMM.  Currently, Clipper 
  315.             can not take advantage of more than eight megabytes of EMM.  
  316.             Please note that the printed documentation is incorrect.  
  317.             This was the cause of many corruptions on systems that had 
  318.             more than eight megabytes of expanded memory.
  319.  
  320.         8.  Fixed an incorrect calculation in _xvalloc() that caused the 
  321.             Virtual Memory Manager to allocate 1K to much if the 
  322.             requested size + 16 (in bytes) was an even multiple of 1024.
  323.  
  324.         9. Fixed an internal calculation that did not account for 
  325.            overflow when converting a segment:offset address to an 
  326.            absolute address.  This could only be encountered by calling 
  327.            the VM API function:_xvalloc().
  328.  
  329.        10. Fixed several problems in the DBFCDX replaceable database
  330.            driver.
  331.  
  332.        11. Fixed a compatability problem between CA-Clipper Tools-II and
  333.            CA-Clipper 5.2x.  Developers using CA-Clipper Tools-II 
  334.            noticed unresolved symbols at link time.  The CT2PATCH.OBJ 
  335.            file will resolve these problems and should be included as an
  336.            object on the link line.   Please note that CT2PATCH.OBJ is 
  337.            only intended for use with CA-Clipper Tools-II, those not 
  338.            using CA-Clipper Tools-II should not include this file in 
  339.            their applications.
  340.  
  341.        12. Fixed DBU so that closing a file with an associated filter 
  342.            will no longer cause a DBCMD/2001 error.
  343.  
  344.        13. Fixed DBU so that performing a replace will no longer cause a 
  345.            "Lock Required" error.
  346.  
  347.        14. Fixed REPORT FORM so header will print when creating a report 
  348.            whose width is greater than 254 characters.
  349.     
  350.        15. Fixed REPORT FORM so that it now ejects properly for groups.
  351.  
  352.        16. Fixed REPORT FORM so that double spaced forms will now print 
  353.            properly.
  354.  
  355.        17. Determined that the EG_SYNTAX error in REPORT FORM was not 
  356.            caused by an empty database.  It was caused by the absence of 
  357.            a field name for the report.  This is the correct behavior.
  358.  
  359.        18. Fixed REPORT FORM so that it will respect the "SUMMARY ONLY" 
  360.            option when requested.
  361.  
  362.        19. Fixed REPORT FORM so that it no longer prints an extra form 
  363.            feed after the report is completed.
  364.  
  365.        20. Fixed RL so that it will save entered data from all entry 
  366.            screens instead of only the current display screen.
  367.  
  368.        21. Fixed RL so that it will no longer save the rightmost column 
  369.            when it is empty.
  370.  
  371.        22. Fixed RL so that it accepts "T" or "F" in it's question 
  372.            fields.  It previously was limmited to "Y" or "N".
  373.  
  374.  
  375.  
  376. ==============================================================================
  377. C: Technical Note: RLOCK()/DBRLOCK() problem
  378.  
  379.  
  380.    o Problem:  
  381.         RLOCK() and DBRLOCK() (without any parameter) will not reliably 
  382.         lock a record under certain circumstances, even though their 
  383.         return values (.T.) indicate success.  This occurs when locking 
  384.         a record in the child database of a relation, after the record 
  385.         pointer has been repositioned by a SEEK or GOTO, but before the 
  386.         data has been accessed.
  387.  
  388.  
  389.     o Solution:  
  390.         A workaround for this problem is to use DBRLOCK( RECNO() ) 
  391.         instead of RLOCK() or DBRLOCK().  A simple way to implement this 
  392.         is:
  393.  
  394.         1. Add the following statements to a copy of the std.ch header 
  395.            file: 
  396.                       #translate RLOCK() => DBRLOCK( RECNO() )
  397.                       #translate DBRLOCK() => DBRLOCK( RECNO() )
  398.  
  399.         2. Re-compile your program with the /u<file> option, where
  400.         <file> is the modified STD.CH file.  
  401.  
  402.  
  403.     o   EXAMPLE:
  404.                   use child shared new
  405.                   set index to childntx
  406.                   use parent shared new
  407.                   set relation to FieldOne into child
  408.                   goto 2
  409. --------------->  if ( rlock() )  // change this rlock() to dbrlock(recno()) 
  410.                      replace child->FieldTwo with parent->FieldTwo
  411.                   endif
  412.                   close data
  413.                   return
  414.  
  415.  
  416.     o Note:  
  417.         This is a temporary workaround while a solution for the problem is
  418.         being worked upon.
  419.  
  420.  
  421.  
  422. ==============================================================================
  423. ==============================================================================
  424.